Skip to main content

Get Statement Analysis​

POST https://api.sat.tausi.africa/v2/tigo/1d_analysis

This analyses the pdf and generates the report. The response is in a json format.

Header Requirements​

  • Authorization --required

Body Params​

  • file --required
  • fullname --required
curl example request
curl -X 'POST' 'https://api.sat.tausi.africa/v2/tigo/1d_analysis'
 -F fullname=Hussein \ 
 -F 'file=@TigoPesa_7865432_Statement.pdf' \
 -H 'Authorization: Bearer XXXXXXXXXXX' \

Response Sample​

  1. Status OK Response
200 OK
{
    "initial_info": {
        "owners_number": 255713XXXXXX,
        "start_date": "2024-04-01T00:00:00",
        "end_date": "2024-05-17T00:00:00",
        "total_days": 46,
        "total_active_days": 41
    },
    "profile": {
        "wallet_balance": 149.0,
        "turnover": 1539551.0,
        "number_of_transactions": 184
    },
    "cashin_flow": {
        "total_cashin": 768790.0,
        "cashin_flow_turnover_percentage": 49.94,
        "cashin_transactions": 63,
        "cashin_trans_total_trans_perc": 34.24
    },
    "cashout_flow": {
        "total_cashout": 770761.0,
        "cashout_flow_turnover_percentage": 50.06,
        "cashout_transactions": 79,
        "cashout_trans_to_total_trans_percentage": 42.93
    },
    "b2w": {
        "total_amount_transferred_from_bank_to_wallet": 12000.0,
        "maximum_amount_transferred_from_bank_to_wallet": 10000.0,
        "number_of_times_trasnferred_from_bank_to_wallet": 2,
        "last_time_transferred_from_bank_to_wallet": "2024-05-01T00:00:00",
        "average_amount_transferred_from_bank_to_wallet": 6000.0
    },
    "w2b": {
        "total_amount_transferred_from_wallet_to_bank": 283000.0,
        "maximum_amount_transferred_from_wallet_to_bank": 100000.0,
        "number_of_times_trasnferred_from_wallet_to_bank": 5,
        "last_time_transferred_from_wallet_to_bank": "2024-05-14T00:00:00",
        "average_amount_transferred_from_wallet_to_bank": 56600.0
    },
    "nivushe": {
        "total_amount_disbursed": 0.0,
        "max_amount_disbursed": 0.0,
        "number_of_disbursed": 0,
        "average_amount_disbursed": 0,
        "last_day_disbursed": "N/A",
        "last_amount_disbursed": 0.0,
        "total_amount_repaid": 0.0,
        "maximum_amount_repaid": 0.0,
        "number_of_times_repaid": 0,
        "last_day_repaid": "N/A",
        "average_amount_repaid": 0,
        "last_amount_repaid": 0.0
    },
    "bustisha": {
        "total_amount_repaid": 0,
        "maximum_amount_repaid": 0,
        "number_of_times_repaid": 0,
        "last_day_repaid": "N/A",
        "average_amount_repaid_in_the_time_period": 0
    },
    "bills_info": {
        "total_amount_used_to_pay_bill": 520950,
        "maximum_amount_used_to_pay_bill": 76,
        "number_of_times_paid_bill": 20500,
        "average_amount_used_to_pay_bill": 6854.61,
        "last_time_paid_bill": "2024-05-17T00:00:00"
    },
    "luku_info": {
        "total_amount_used_to_buy_luku": 9900.0,
        "maximum_amount_used_to_buy_luku": 9900.0,
        "number_of_times_bought_luku": 1,
        "average_amount_bought_luku": 9900.0,
        "last_time_bought_luku": "2024-04-05T00:00:00"
    },
    "p2p_sent_info": {
        "total_amount_sent_to_peer": 230307.0,
        "maximum_amount_sent_to_peer": 77700,
        "Number_of_times_sent_to_peer": 19,
        "last_time_sent_to_peer": "2024-05-16T00:00:00"
    },
    "p2p_received_info": {
        "total_amount_received_from_peer": 114000.0,
        "maximum_amount_received_from_peer": 51000,
        "number_of_times_received_from_peer": 7,
        "average_amount_received": 16286.0,
        "last_time_received_from_peer": "2024-05-15T00:00:00"
    },
    "agent_withdraw": {
        "total_amount_withdrawn_via_agent": 0,
        "maximum_amount_withdrawn_via_agent": 0,
        "number_of_times_withdrawn_via_agent": 0,
        "average_amount_withdrawn": 0,
        "last_time_withdrawn_via_agent": "N/A"
    },
    "agent_deposit": {
        "total_amount_deposited_via_agent": 359700.0,
        "maximum_amount_deposited_via_agent": 20000,
        "number_of_times_deposited_via_agent": 47,
        "average_amount_deposited_via_agent": 7653.19,
        "last_time_deposited_via_agent": "2024-05-17T00:00:00"
    },
    "airtime_topup": {
        "total_amount_toped_up_airtime": 9500.0,
        "maximum_amount_toped_up_airtime": 5000,
        "number_of_times_toped_up_airtime": 6,
        "last_time_toped_up_airtime": "2024-05-16T00:00:00"
    }
}

  1. Bad Request Response
400 Bad Request
message: "<The specific error message>"

  1. Unprocessable Entity
422 Unprocessable file entity
message: "Unprocessable File Entity"

  1. Rate Limit Error
429 Rate Limited Error
message: "Rate limited resource",
nexttime:"19876543"

Rate Limiting!

Rate Limited Resource Continous Access will lead to blocking an account.

  1. Internal Server Error
500 Internal Server Error
message: "An Internal server error",